Predefined Debugger Variables 


$fpasingle 
$fpustackall 
Shexchars 
Shexfloats 
Shexin 


Shexints 
Shexoffsets 


Shexstrings 


$listwindow 


$noframe 


$nostrict 


$octin 


$whichreg 


If set, Pdbx prints floating-point registers as 
single-precision numbers. 
If set, Pdbx prints nonzero floating-point stack 
entries even if in empty state (80387 FPU 
only). 
If set, Pdbx prints characters in hexadecimal. 
If set, Pdbx prints floating-point stack 
registers in hexadecimal. 
If set, Pdbx interprets integers in command 
input as hexadecimal. 
If set, Pdbx prints integers in hexadecimal. 
If set, Pdbx prints offsets from registers in 
hexadecimal. 
If set, Pdbx prints character arrays in 
hexadecimal. 
Default number of lines to display with the 
list command, If not set, Pdbx prints 10 lines. 
When used with list proc for listing a 
procedure, Pdbx lists $listwindow lines 
around the beginning of the procedure. 
If set, Pdbx does not follow the chain of call 
frames on the stack. This allows access to 
global variables and register contents in code 
that does not have conventional stack frames. 
If set, Pdbx relaxes type checking rules for 
call and assign commands. 
If set, Pdbx interprets integers in command 
input as octal. If $hexin is set, $octin is 
ignored. 
If set, Pdbx includes the register name with 
the information displayed by the whatis 
command for the specified variable. Your 
program must declare the storage class for the 


variable as type register. Valid for C 
programs only. 
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Type Conversion 


To coerce the value of expression expr to type 
typename , use the construct expr \typename 
To coerce the value of expression expr toa 
pointer to type typename , use the construct 
expr\ &typename. If typename is a struct 
precede it with a double dollar sign ($$). , 


If Pdbx prints the message incompatible 

types or type mismatch after you enter a 
command that includes type conversion, you 
can use the set $nostrict command to relax 


type-checking rules and then reenter the 
command. 


Formats 


The following table lists the formats you can 


use with the address/ and address= commands. 


machine instruction 
short word 


decimal 


long word decimal 
short word octal 

long word octal 

short word hexadecimal 
long word hexadecimal 
byte octal 
character n/a 


null-terminated string 
single-precision real 


mnrnoa tex Oona» 


double-precision real 


44 short word is 16 bits; a long word is 32 bits. 


Identifiers Containing Special Characters 


When entering an identifier that contains 
special characters (such as a period) He en 
identifier that is also a Pdbx reserve word, 
you should enclose the jdentifier in back 
quotes. For example, entering the following 
command instructs Pdbx to stop 1n the routine 
._SQRT: 


stop in ‘._SQRT* 


Register Names 


Processor 


program variable declared with the register keyword 


The following aliases are also supported: pc for eip, 
sp for esp, and fp for ebp. 


Pdbx 
Quick 


Reference 
Card 


1003-48548-00 


Invoking Pdbx 


Use one of the following syntax forms to invoke 
Pdbx. Use the first form when debugging an 
application that consists of a single program; use 
the second form when debugging applications that 
consist of multiple programs. Invoking Pdbx as 
pdbx is useful when debugging a parallel program; 
invoking Pdbx as dbx is useful when debugging a 
program that creates child processes and only the 
parent process is of interest. 


{ee| -iat-wit-alt-efteIt-tar. 
[ execfile [ coredump)] 


{rgb (iy (-u1{-a1t-efle tar. 
~O execfile } ... [ -Q execfile } ...[-C coredump }... 


Exiting Pdbx 
Enter the following command to exit Pdbx: 


quit 


Pdbx Command Summary 


Creating and Executing Processes 


Yon 


Change the current process ton 


call procedure 
([parameters]) 


cont [* pial [sienat] 


[to soureeline| [«| 


create [execfile] [args] 
[<infile] [> outfile] 


%procnum 
next | all \[e] 


Execute specified procedure 


Resume process execution 


Create new process; use cont 
to execute the process 


Execute next line or, if the next 
line calls a procedure, execute 
the entire procedure 


ps [%procnum] Print processes and their 
states; an asterisk (*) in the 
resultant display marks the 


current process 


release %procnum 


Release process from Pdbx 
control 


rerun [execfile] [args] Same as run except uses 
[<infile] [>outfile] arguments specified with last 
[s] run or create command when 
no arguments are specified 


return [procedure] 


Continue until current procedure 
returns or until return to the 
specified procedure 


run [execfile] [args] 
[<infile] [> outfile} 


Create and execute a new 
process; terminate old processes 


[&] 
step [ sphegeean| [«] Execute next source line 
terminate hegee Terminate processes and remove 


from process list 


Tracing, Breakpoints, and Signals 


event ] 


catch Ee nal Stop process when specified signal 


or event occurs 


delete cmdnumber ... Cancel the breakpoint or 
tracepoint associated with 


emdnumber 


event ] 


ignore Lee nal Do not stop when specified signal 


or event occurs 


Send the signal specified by sig to 


all one or all processes 


signal page| sig 


status [> filename] 


stop [procid] 
in procedure 
[if condition] 


stop [procid] _ 
at sourceline 
[if condition] 


stop [procid] variable 
[if condition] 


stop [procid] 
if condition 


stop all 


trace [procid] 
[in procedure] 
[if condition] 


trace [procid] 
sourceline 
[if condition] 


trace [procid] 
procedure 
[in procedure] 
[if condition] 


trace [procid] 
expression 
at sourceline 
[if condition] 


trace [procid] variable 
{in procedure} 
[if condition] 


alias name cmdname 
alias name "emdstring" 


alias name (parameter 
[,parameter] ... ) 
“emdstring" 


alias [name] 
unalias name 


set [name [=expression]] 


unset name 


Tracing, Breakpoints, and Signals (cont.) 
Print active breakpoints and 
tracepoints 


Stop execution on entry to 
procedure 


Stop before executing specified 
source line 


Stop when value of variable 
changes 


Stop when condition becomes true 


Stop all running processes 


Print trace information as process 
executes 


Print specified source line each 
time it is encountered (before 
executing it) 


Print which procedure called 
procedure and value of each 
parameter passed to it 


Evaluate and print expression 
before executing code at the 
specified source line 


Print value of variable each time it 
changes 


Command Aliases and Debugger Variables 


Define an abbreviation for a 
Pdbx command name 


Define an abbreviation for a 
Pdbx command string 


Define an abbreviation for a 
Pdbx command string with 
replaceable parameters 


Print current aliases 


Undefine name as an alias 


Set a debugger variable 


Delete the specified debugger 
variable 


dump [procedure] 
[> filename] 


print expression 
[, expression] 


print fpustack 


/pattern[/)] 


?pattern[?] 


edit [sourcefile] 


edit procedure 


file [[%execfile] 
sourcefile} 


list [linenumber 


list procedure 


use, [%execfile] 
(directory...] 


Examining and Altering Variables 


assign variable=expression 


Accessing Source Files 


[, linenumber] ] 


Assign value of expression to 
variable 


Print names and values of 


variables in current procedure 


Print value of variable or 
expression 


Print contents of 80387 FPU 
registers 


Search forward for specified 
pattern 


Search backward for specified 
pattern 


Edit current source file 


Edit current source file and 
place cursor at beginning of 
specified procedure 


Use sourcefile as current source 
file 


Print source lines in the current 


source file 


List specified procedure 


Add directory to source file 
directory search list 


Examining and Altering the Current Context 


down [nlevels] 


func [procedure] 


up [nlevels] 


whatis identifier 
where [%procnum] 


Change the current procedure to 


the procedure nlevels down the 
stack 


Change the current procedure 
and current source file 
designations to the specified 
procedure 


Change the current procedure 
to the procedure nlevels up the 
stack 


Print declaration for identifier 
Print traceback 


Examining and Altering the Current Context (cont.) 


whereis identifier Print qualified names for all 


instances of identifier 


which identifier Print qualified name for 


identifier in the current context 


Machine-Level Debugging 


address, address / 
[format] 


Print values in memory in 
specified address range 


address/ [count] 
[format] 


Print count values in memory 
starting at address 


Print value of the number 
specified by address in the 
specified format 


address= [format] 


listi [linenumber 
{ , linenumber]] 


Disassemble and print 
instructions 


listi procedure Disassemble and print 
instructions for specified 


procedure 


Execute next instruction or, if 
next instruction calls a proce- 
dure, execute entire procedure 


. | %procnum [«] 
next [ ail, ][« 


stent [eee] [«] 


Execute next instruction 
all 


stopi [procid] 
[at] address 
[if condition] 


Stop before executing the 
instruction at address 


tracei [procid] 
[in procedure] 
[if condition] 


Trace program at machine level 


tracei [procid] address 
[if condition] 


Print instruction at specified 
address before it executes 


tracei [procid] variable 
[at address] 
[if condition] 


Print value of variable before 
execution of instruction at 
specified address 


Miscellaneous Commands 


help Print synopsis of frequently used 


Pdbx commands 


sh [commandline] Create new shell and pass it the 


specified command line 


source filename Execute Pdbx commands in 


filename 


suspend 


Suspend Pdbx and return to 
shell; use csh’s fg to resume 


